Installing the WEM Software

 

This chapter provides the step-by-step procedure of installing WEM application using the GUI-based installation wizard and the console-based installation. Additionally it provides instructions that need to be followed before starting the WEM installation so that it completes successfully.

This chapter includes the following topics:

•	Before You Begin

•	Setting the PostgreSQL Database System Environment Configurations

•	Unpacking the Installation Files

•	Determining the Best Installation Method

•	Installing the WEM Software using the GUI-Based Installation Wizard

•	Installing the WEM Software using the Console-Based Installation Method

•	Configuring IPMP on WEM Server

Important: Unless otherwise specified, the information in this chapter applies to both Sun Solaris and Red Hat Enterprise Linux-based (RHEL) WEM systems.

Before You Begin

Prior to performing the installation procedure, this section previews each step to ensure that your ready to successfully complete the installation. Detailed installation instructions follow.

Important: Special rules apply when you are installing redundant High Availability servers using Oracle or Veritas clustering software. Refer to the appendices for more information.

Step 1 - Verifying Hardware Status

The first thing that you need to do is to ensure that the WEM server hardware has been provisioned properly for your application. This includes:

•	Verifying the correct operating system. This can be accomplished by entering the uname -a command.

•	Verifying that the hard disk has been partitioned properly using the recommendations outlined in the WEM Server Hardware Sizing and Provisioning Guidelines section of the WEM Port and Hardware Information chapter.

•	Verifying network connectivity through the management LAN.

Step 2 - Setting the WEM Server's Database Environment Strings

This step is required to configure how the PostgreSQL database engine processes, stores, and retrieves information contained in the various databases stored using the UNIX file subsystem. Failure to configure these settings may cause data loss and will minimally cause errors in the WEM's operation. Special instructions apply for updating the Postgres database if you are installing redundant High Availability servers using clustering software. Refer to the appendices for more information before you start installation.

Step 3 - Unpacking the WEM Application Files

WEM installation files are distributed as a single compressed file. Once the file is obtained, it must be copied to the server and unpacked. It is recommended that you copy the file to a temporary directory on the server.

Step 4 - Installing the WEM Software

This step consists of choosing the desired installation method (console-based or the Graphical User Interface (GUI-based) and performing the physical installation onto the WEM server. There are three software components that are installed as part of this procedure. They are:

•	WEM software

•	Apache Web Server software

•	PostgreSQL database engine software

Important: If you are installing the WEM to upgrade an existing version that is currently installed and running, proceed to Upgrading the WEM Software chapter of this guide. If you are installing redundant High Availability servers using Clustering software, you should also refer to the appendices for special instructions.

Step 5 - Configuring WEM Client Session Management Parameters

There are numerous client session management parameters that control how many client sessions may be simultaneously accessed, idle timeout periods, and various other client-related items. This configuration file, which resides on the WEM server, should be modified (if needed) prior to starting the WEM server processes.

Caution: Failure to perform the WEM server startup procedure in the exact order shown in this document may prevent the application from initializing and working properly.

Step 6 - Configuring IP Multipathing (IPMP) on WEM Server (Optional)

IPMP, or IP multipathing, is a facility provided by Solaris® to provide physical interface failure detection and transparent network access failover for a system with multiple interfaces on the same IP link. IPMP also provides load spreading of packets for systems with multiple interfaces.

For IPMP configuration, refer to the Configuring IPMP on WEM Server section.

Important: IPMP is a feature supported on Solaris® platforms provided by Oracle. The configuration is documented in the various User Guides from Oracle.

Setting the PostgreSQL Database System Environment Configurations

Prior to installing the WEM application onto the WEM server hardware, there are numerous system environment configuration settings that should be configured. While PostgreSQL is installed during the GUI-based installation procedure, these settings must be configured manually.

Red Hat Enterprise Linux (RHEL) Servers

In the System Settings Check Panel, ensure that following entries are present in '/etc/sysctl.conf'

•	kernel.shmmax=536870912

•	kernel.shmall=2097152

If one or more entries are missing then abort installation, update '/etc/sysctl.conf', restart the system and re-run installer.

Solaris Servers

In Solaris, the user has to edit the /etc/system file.

Add the following values to the system file in the /etc directory and restart the system before continuing with the installation of the WEM application:

set msgsys:msginfo_msgmnb=65536

set msgsys:msginfo_msgtql=1024

set shmsys:shminfo_shmmax=0x20000000

set shmsys:shminfo_shmmin=1

set shmsys:shminfo_shmmni=256

set shmsys:shminfo_shmseg=256

set semsys:seminfo_semmap=256

set semsys:seminfo_semmni=512

set semsys:seminfo_semmns=512

set semsys:seminfo_semmsl=32

Configuring PostgreSQL Database System Environment

Configuring PostgreSQL Database System Environment
Step	Action	Observation
The start point for this procedure is the UNIX shell prompt.
	Type the vi command:vi /etc/system <Enter>	Opens the vi editor and the file where the database strings are located.
	Type the end of file command.<Shift> G <Enter>	This places the cursor at the bottom of the file in the append mode.
	Type the following environment settings:	Allows the user to enter the new system settings for the database environment.
	set msgsys:msginfo_msgmnb=65536set msgsys:msginfo_msgtql=1024set shmsys:shminfo_shmmax=0x20000000set shmsys:shminfo_shmmin=1set shmsys:shminfo_shmmni=256set shmsys:shminfo_shmseg=256set semsys:seminfo_semmap=256set semsys:seminfo_semmni=512set semsys:seminfo_semmns=512set semsys:seminfo_semmsl=32
	Verify a lower case letter “L” was used in the msgtql and semmsl entries.
	Press <Esc>.	Returns the user to the command mode.
	Type the write to file and save command::wq! <Enter>	Writes the changes to the current open file and exits the vi editor.
	Type the reboot command.reboot <Enter>A warm reboot may be performed by pressing <Ctrl-Alt-Delete>.	Reboots the system and applies the changes in the /etc/system file.
	- END OF PROCEDURE -

‌

Unpacking the Installation Files

WEM installation files are distributed as a single compressed file with a “.tar.gz” extension.

Once the installation file has been copied to the server, use the following procedure to unpack the file.

Step 1

Go to the directory in which the file is stored.

Step 2

Unzip the file by entering the following command:

gunzip file_name.tar.gz

file_name is the name of the WEM application installation file.

Step 3

Un-tar the file by entering the following command:

tar -xvf file_name .tar

Decompressing the installation file results in the following files:

•	setup.bin: The installation binary file.

•	inst: The executable file used to initiate the installation. This file is used for both the console- and the GUI-based methods.

•	uninst: Once the WEM application has been installed, this file must be copied to the /<ems_dir>/_uninst/ directory. It is the executable file for uninstalling the application for both the console- and GUI-based methods.

•	file_name.tar: A compressed file containing all of the application files required for both the script- and GUI-based installation methods.

•	README: A text file containing information pertaining to the release.

•	sqlfiles.tar: Script Query Language files related to WEM database functionality.

•	ems_migrate: A script that performs a backup or restore of the WEM databases.

•	ems_migrate.cfg: A file that contains configuration information related to the ems_migrate script.

•	README.ems_migrate: A text file containing information related to the EMS migrate functionality.

Determining the Best Installation Method

The WEM and its ancillary components such as the Apache web server and PostgreSQL database engine, may be installed in one of the following two methods.

•	GUI-based method: This method is the most commonly used installation procedure. Requirements for using this method include:

•	Logon account to the WEM server with display terminal (monitor) attached and some X-Windows client installed on the server.

•	Network connectivity to WEM server via Telnet or SSH, using some X-Windows client on a remote workstation.

•	Console-based method: This method is available to users who do not have an X-Windows client available for remote network connectivity to the WEM server via Telnet or SSH.

Installing the WEM Software using the GUI-Based Installation Wizard

Follow the instructions below to install the WEM using the GUI-based installation wizard.

Important: If you are installing the WEM to upgrade an existing version that is currently installed and running, proceed to the Upgrading the WEM Software chapter of this guide. If you are upgrading software on redundant High Availability servers using clustering software, you should refer to the appendices.

Step 1

Go to the directory in which the WEM installation files are located.

Step 2

Execute the setup file by entering the following command:

./inst

The WEM Installer dialog appears:

Step 3

Click Next to proceed.

Step 4

Follow the on-screen prompts to progress through the various installation dialogs and configure the parameters as required. Refer to the following table for descriptions of the configurable parameters on each of the installation dialogs.

Parameter	Description	Default Value
System Setting for Postgres
N/A	This dialog or script section is informational and contains no configurable parameters. Information pertaining to these variables is located in the Setting the PostgreSQL Database System Environment Configurations section in this chapter.	N/A
EMS Installation Mode
Standalone EMS Failover Mode	This dialog or script section determines how the installation will proceed depending on the type of environment the EMS will be running in. Select Failover Mode if you are configuring a redundant High Availability Cluster. Important: Future releases will support a Scalable installation mode.	Enabled
Destination directory for Element Management System
Directory Name	The directory on the server in which the WEM is to be installed. The directory can be manually entered in the field provided or selected using the Browse function. Important: If you are configuring a High Availability installation using redundant servers in an Oracle Cluster environment there are certain requirements regarding identical setups on both servers. Refer to the appendices for more information before proceeding.	/<ems_dir>/ which is /users/ems by default
Global Configuration
Select the IP Address	Choose this option to select one of the server IP addresses automatically detected by the WEM installation process. For the GUI-based installation, the IP address is selected from the drop-down menu.	Null
Enter the IP Address	Choose this option to manually specify an IP address. This option can be used to specify an address that has not yet been configured on the server The IP address must be entered in the field provided. Important: The IP address specified must be ICMP reachable.	Null
SSL Configuration
Enforce SSL	If this option is selected, then the Secure Sockets Layer (SSL) connection is established for client-to-server and server-to-boxer communication. By default, the SSL encryption feature is enabled. Important: If the Enforce SSL option is enabled, the configuration settings for the chassis should be changed as needed.	Enabled
Content Filtering / Blacklisting Configuration
Enable Content Filtering	Select this option to enable the content filtering service on WEM. This option when enabled allows the user to configure the Master Content Rating Database Server (MCRDBS) and Central Decision Point (CDP). By default, this option is enabled.	Enabled
Enable Blacklisting	Select this option to enable the blacklisting feature on WEM. If this option is enabled, the WEM pulls the files containing the blacklisted URLS from external agency, converts them into binary format and then pushes it to the CDP.	Enabled
EMS Client Configuration
WEM Identifier Information	If applied at installation time, this identification information will allow users to know which particular WEM they are logged into: useful for working with more than one WEM keeping track of multiple screens. This text would be saved to the img.html and imgdebug.html files so each time the user logged in the data would be retrieved and provide the WEM identifier detail on each screen automatically.
Fixed Port Range
Fixed Port	There are a number of applications on the WEM that require event notifications such as graphing, protocol monitoring, Front and Rear view (FRV) screens, alarms, and software upgrades. Each one requires a dedicated port for itself. Select this option if the WEM Server is to send requests (notifications) to WEM Clients on fixed ports. This is useful if a firewall exists between the Server and the Client. The assigned ports can be opened in the firewall to allow notifications. By default, if enabled, the Server uses a block of 11 ports beginning with the port number specified in by Start Port. If this option is not enabled, the operating system randomly selects open ports for use.	Disabled
Start Port	If the Fixed Port option is enabled, this parameter specifies the initial port number to use for the block of consecutive fixed ports. The port can be configured to any integer value from 1 through 65535. Important: Ports 1 to 1024 are reserved and should not be used.	40000
End Port	If the Fixed Port option is enabled, this parameter specifies the last port number to use for the block of consecutive fixed ports. The port can be configured to any integer value from 1 through 65535. Important: Ports 1 to 1024 are reserved and should not be used.	40010
Content Filtering Configuration
Master Content Rating Database (MCRDBS):
MCRDBS User Name	Enter a username for the MCRDBS in the field provided.	Null
MCRDBS Password	Enter a password for the MCRDBS user in the field provided. The password is case sensitive.	Null
MCRDBS Host IP Address	Enter the host IP address of the MCRDBS to which Content Filtering server statistics files are to be sent.	Null
MCRDBS Host Name	Enter the host name for an MCRDBS server in the field provided.	Null
Full Database Import Interval(Hrs)	Enter the time interval in hours for Content Filtering Server to import various databases from MCRDBS (Databases: SFMDB). The range is from 2 to 4320 hours.	24
Incremental Database Import Interval(Hrs)	Enter the time interval in hours for Content Filtering Server to import various databases from MCRDBS (Databases: SFMDB-INC). The range is from 2 to 720 hours.	24
Full Database Backup Limit (number)	Enter the backup limit for full databases.	4
Incremental Database Backup Limit(Days)	Enter the backup limit in days for incremental databases.	30
Full Database Import Path	Enter the path to locate the SFMDB files in MCRDBS. For example: <Mcrdbs server path>/cfems/<cfems ip address>/sfmdb	Null
Incremental Database Import Path	Enter the path to locate the SFMDB-INC files in MCRDBS. For example: <MCRDBS server path>/cfems/<cfems ip address>/sfmincdb	Null
Archive Database Files	Select 1 if you want to archive the database files.	1
Central Decision Point (CDP):
CDP User Name	Enter a username for the CDP in the field provided.	Null
CDP Password	Enter a password for the CDP user in the field provided. The password is case sensitive.	Null
CDP Host Name	Enter the CDP host name in the field provided.	Null
CDP Host IP Address	Enter the host IP address of the CDP to which CDP statistics files are to be sent.	Null
Optimized Database Export Interval(Hrs)	Enter the time interval in hours for Content Filtering Server to export the OPTCMDB files to CDP. The range is from 2 to 4320 hours.	72
Optimized Incr Database Export Interval(Hrs)	Enter the time interval in hours for Content Filtering Server to export the OPTCMDB incremental files to CDP. The range is from 2 to 720 hours.	24
Optimized Database File Export Path	Enter the path for Content Filtering Server to export the OPTCMDB files to CDP.	Null
Trap Configuration	Select 1 to enable trap notifications.	1
Blacklisting Configuration
NCMEC Configuration:
URL	Enter the cumulative.csv file path at NCMEC.	Null
User Name	Enter the username required for authentication at the NCMEC site.	Null
Password	Enter the password required for authentication at the NCMEC site.	Null
Import interval(Hrs)	Enter the cumulative.csv file import interval in hours.	24
Export to CDP interval(Hrs)	Enter the time interval in hours for Content Filtering Server to export OPTCMDB-BL to CDP. The range is from1 to 5 hours.	2
Apache Server Configuration
Apache Port (HTTP)	Enter the TCP port that the Apache web server communicates on in the field provided. Enter the port number as an integer, ranging from 0 through 65535.	80
Apache Port (HTTPS)	Enter the TCP port that the Apache web server communicates securely on in the field provided. Enter the port number as an integer, ranging from 0 through 65535. Important: Apache port HTTP and HTTPS both should be different to establish the successful connection between WEM client and WEM server.	443
Administrator Email-ID	Enter an e-mail address for the web server administrator in the field provided. Use the username@domain format.	root@localhost
EMS Server Configuration
IMG Session Management (ISM):
Corba Communication Port	Enter the TCP port over which CORBA communication occurs with the system in the field provided. Important: This field will not be displayed if the Enforce SSL parameter in the SSL Configuration panel is enabled. Important: This setting must be identical to the iiop-port setting on the system. The parameter entered here is used as a default value by the application. Once the server installation is complete, a chassis to be managed can be configured each with their own IMG Port value through the client interface. Enter this value as an integer, ranging from 0 to 65535.	14132
Corba Communication Port (SSL)	Enter the port over which CORBA communication occurs with the system in the field provided. The corba communication port is configured same as the SSL port on the boxer. Important: This field will not be displayed if the Enforce SSL parameter in the SSL Configuration panel is disabled. Important: This setting must be identical to the siop-port setting on the chassis. The parameter entered here is used as a default value by the application. Once the server installation is complete, additional ASR 5000s to be managed can be configured with unique ASR 5000 Port values through via the WEM client interface. Enter this value as an integer, ranging from 0 to 65535.	14131
Application Server ID	Enter the name by which the WEM CORBA application server is identified to the chassis. Important: This name must match the Application Server ID name configured on the chassis for WEM to be able to manage the system. The Application Server ID name entered here is used as a default value by the application. Once the server installation is complete, additional ASR 5000s to be managed can be configured with unique Application Server ID names via the WEM client interface.	CISCO
Application Server Password	Enter the password used by the WEM CORBA application server when communicating with the chassis. Important: This password must match the Application Server Password configured on the chassis for WEM to be able to manage the system. The password entered here is used as a default value by the application. Once the server installation is complete, additional ASR 5000s to be managed can be configured with unique passwords via the WEM client interface.	Null
Network Management System (NMS):
FTP User Name	Enter a name for the WEM user with FTP privileges on the chassis in the field provided. For FTP to work properly between the WEM server and any chassis, an administrator user with FTP privileges must be configured through the system’s CLI. It is highly recommended that this CLI administrator be configured using the “nocli” option, allowing only FTP privileges into the system. If the WEM server is to manage multiple chassis, then this same CLI user must be configured on each of the chassis.	staradmin
FTP Password	Enter a password for the FTP user in the field provided. The password is case sensitive.	Null
User Limit	Enter the maximum number of WEM users that can simultaneously access the server. The number can be configured to any integer value from 1 through 100.	10
Security Admin Limit	Enter the maximum number of WEM users with Security Administrator privileges that can simultaneously access the server. The number can be configured to any integer value from 1 to the number specified as the User Limit.	5
User Session Limit	Enter the maximum number of sessions allowed for a single WEM user. The number can be configured to any integer value from 0 to the number specified as the User Limit. A value of 0 disables the implementation of user limits on a per-context basis.	5
Context User Limit	Enter the maximum number of Web Element Management user sessions allowed on a per-system context basis. The number can be configured to any integer value from 0 to the number specified as the User Limit. A value of 0 disables the implementation of user limits on a per-context basis.	5
FTP Session Limit	Enter the maximum number of simultaneous FTP sessions allowed to the chassis through the WEM. The number can be configured to any integer value from 1 through 20.	5
Storage Server Directory	Enter the name of the directory in which the WEM database backup files would be stored.	./flash
Syslog Config File	Enter the directory path for the syslog configuration file. This is needed for the WEM’s syslog event viewing functionality. Important: If the file is not found in the specified directory, an error message is displayed.	/etc/syslog.conf
EMS Server Configuration (contd.)
Fault Management (FM):
SNMP Trap Port	Enter the TCP port over which SNMP traps are received from the system in the field provided. Enter this value as an integer, ranging from 0 to 65535.	162
SMTP Server Name	Enter a host name or IP address for a Simple Mail Transfer Protocol (SMTP) server, if needed, in the field provided. This is the mail server to which notifications are sent. Important: This parameter must be configured in order to send e-mails to new users when a trap is generated. E-mail can be configured for a trap in Alarm Configuration screen. 'SMTP Server name' is used as the E-mail Server for those mails.	Null
Sender Email-ID	Configure the e-mail address to which the system is to send notifications in the field provided. The e-mail address should be in the form username@domain. Important: This parameter must be configured in order to send e-mails to new users when a trap is generated. E-mail can be configured for a trap in Alarm Configuration screen. 'Sender E-mail ID' is used as the 'From' (Originator) for those mails.	Null
Bulk Statistics:
Bulkstat FTP User Name	Enter the name of the user with FTP privileges on the external network management server. This parameter is used in conjunction with the Bulkstat FTP Perform Operation parameter.	anonymous
Bulkstat FTP Password	Enter the password of the user with FTP privileges on the external network management server. This parameter is used in conjunction with the Bulkstat FTP User Name parameter.	Null
Host IP Address	Enter the IP address of the external network management server to which XML-parsed bulkstatistic files are to be sent. This parameter is used in conjunction with the Bulkstat FTP Perform Operation parameter.	127.0.0.1
Host Base Directory	Enter the directory on the external network management server to which the bulkstatistic files are to be written. The default directory is /tmp. This parameter is used in conjunction with the Bulkstat FTP Perform Operation parameter.	/tmp
Archive Bulkstat Files	Select this option if the WEM is to archive bulkstatistic information from the chassis. Archived data is stored to the /<ems_dir>/server/bulkstat_archive directory by default.	Disabled
Generate XML Files	Select this option if the server is to create XML files containing processed bulkstatistic information for forwarding to a remote server. XML-parsed data is stored in the /<ems_dir>/server/xmldata directory by default. Important: Since the Bulkstat Server process is responsible for XML file generation, if this option is not enabled, the Bulkstat Server process is not started.	Disabled
Bulkstat FTP Perform Operation	Select this option if the server is to transfer XML-parsed bulkstatistic data files to an external network management server. Bulkstatistic information retrieved from the chassis via FTP is stored in the /<ems_dir>/server/data directory by default prior to processing.	Disabled
User Administration
EMS Administrator E-Mail Address	Enter an e-mail ID to be used as the originator for e-mails generated during new user account creation or password resets.	Null
Hardware Inventory
Hardware Notifier Email-ID	Enter an e-mail ID to be used as the originator for e-mails generated as a result of a hardware change.	Null
EMS Process Monitor Configuration
Poll Interval (sec)	Enter the frequency at which process table queries are performed. The interval is measured in seconds.	30
Number Of Retries	Configure the number of times the system attempts to communicate with a process prior to taking action. If the process has not responded to the final attempt within the configured timeout interval, the system considers it unreachable and takes action.	10
Timeout Interval (sec)	Configure the amount of time the system should wait prior to re-attempting to communicate with an un-responsive process in the field provided. The interval is measured in seconds. Once the time interval has been reached, the system re-attempts communication for the configured number of retries prior to considering the process unreachable and taking action.	330
SMTP Server Name	Enter a host name or IP address for a Simple Mail Transfer Protocol (SMTP) server, if needed, in the field provided. This is the mail server to which notifications are sent when processes fail/start.	Null
To Email-ID	Configure the e-mail address of the individual to be notified in the field provided. E-mail notifications are sent to this individual when the system cannot communicate with a process. The e-mail address should be in the form username@domain.	Takes setting from previous SMTP parameter.
Monitor Process	EMS Process Monitor functionality is capable of monitoring WEM server processes at pre-configured intervals. In the event of a process becoming unresponsive, the system sends notifications and can re-spawn the process. Refer to the WEM Process Monitor chapter for additional information. Important: Special rules apply to starting processes that will update dateabases whenever you are installing redundant WEM servers using Oracle Cluster Software. Refer to the appendices for more information before starting database processes. The following processes can be monitored: • EMS Server • Bulkstat Server • Bulkstat Parser • Script Server • Northbound Server	• EMS Server: Enabled • Bulkstat Server: Disabled • Bulkstat Parser: Enabled • Script Server: Disabled • Northbound Server: Disabled
Postgres Configuration
User Name	Enter a username for the Postgres database administrator in the field provided. Caution: To ensure proper operation and data integrity, the PostgreSQL database instances installed with the WEM should only be used by the application.	postgres
Password	Enter a password for the user in the field provided. The password is case sensitive.	Null
Use Local Installation	Select this option to install Postgres on the local server If enabled, the system's local IP address of 127.0.0.1 is used. Important: This option is not present in the console-based installation script.	Enabled
Use Remote Installation	Select this option to install Postgres on a remote system. If enabled, configure the IP address of the server in the field provided. Important: This option is not present in the console-based installation script.	Disabled
Element Management System Installation Confirmation
	This dialog or script section is informational and contains no configurable parameters.	N/A
Component Starting Panel (Select the components to be started)
Select the components to be started	Select the WEM software components to start as part of the installation. Important: Special rules apply to starting services and databases when you install redundant WEM servers using Oracle Cluster Software. Refer to the appendices for more information before continuing. The following components are available: • Apache Server • EMS Processes • Restore old Postgres 7.2.4 database into new postgres 8.2.0 Upon selecting the component “Restore old postgres 7.2.4 database into new postgres 8.2.0”, the postgres database migration is started from older version to the new version as WEM releases 7.0 and later support only Postgres version 8.2.0. For more details on the database migration process, refer to the log file .dbmigration.log in the /<ems_dir>/server/log directory. Important: Successful installation of the WEM application requires that the Apache Server and EMS processes be started. The default setting is to enable them. Though prompts are provided to disable them, it is highly recommended that you do not modify the default behavior.	All components selected
Startup Script Panel
Start EMS at machine startup	Select this option to enable the WEM to start automatically each time the server on which it is installed is rebooted. Important: This must be disabled if you have a redundant High Availability server cluster. See the appendices for more information.	Enabled

‌

Once all components have started, a dialog box appears confirming that the installation was successful.

Step 5

Click the Finish button to exit the GUI-based installation wizard.

Step 6

Verify that all WEM processes were successfully started by looking at the on-screen messages in the console window. The following provides a sample of the messages:

Starting WEM Server...

WEM Server started.

PID: 1370

Logfile generated as:

./log/SERVER_LOG_20051220_142931/SERVER_LOG

Starting Script Server...

Script Server started.

PID: 1389

Logfile generated as:

./log/SCRIPT_LOG_20051220_142937/SCRIPT_LOG

The following table lists the processes that are started at installation.

Process	Log File
EMS Server	.server.log
Script Server	.scriptserver.log
BulkStat Server	.bulkstatserver.log
BulkStat Parser Server	.bulkstatparser.log
Monitor Server (if enabled)	.watchdog.log
NorthBound Server	.northboundserver.log
Notification Service	.notifyservicescript.log

‌

All log files are stored in the /<ems_dir>/server/log directory by default. Refer to log files for additional information in the event that one or more of the processes did not start properly.

Step 7

Copy the un-installation script to the _uninst directory created during the installation process (/<ems_dir>/_uninst by default) by entering the following command:

cp uninst /<ems_dir>/_uninst/

Step 8

Copy the files related to the WEM migrate script to the scripts directory (/<ems_dir>/server/scripts by default) created during the installation process by entering the following commands:

cp ems_migrate /<ems_dir>/server/scripts

cp README.ems_migrate /<ems_dir>/server/scripts

Step 9

Proceed to the WEM Server Files and Operation chapter of this guide for additional information on WEM Server files and functionality.

Important: Please contact Cisco support for default Username and Password.

Installing the WEM Software using the Console-Based Installation Method

Follow the instructions below to install the WEM using the console-based installation script.

Important: If you are installing the WEM to upgrade an existing version that is currently installed and running, proceed to the Upgrading the WEM Software chapter of this guide.

Step 1

Go to the directory in which the WEM installation files are located.

Step 2

Execute the setup file by entering the following command:

./inst -console

A message appears welcoming you to the WEM installation.

Step 3

Enter “1” to proceed.

Step 4

Follow the on-screen prompts to proceed through the installation script and configure the various parameters as required. Refer to the WEM Installation Parameter Descriptions table for descriptions of the configurable parameters within each of the sections of the script.

Once you have completed the installation configuration and all processes have started, you receive a message indicating that the WEM was successfully installed.

Step 5

Enter “3” to finish the installation.

Step 6

Verify that all WEM processes were successfully started by looking at the on-screen messages in the console window. The following provides a sample of the messages:

Starting WEM Server...

WEM Server started.

PID: 1370

Logfile generated as:

./log/SERVER_LOG_20051220_142931/SERVER_LOG

Starting Script Server...

Script Server started.

PID: 1389

Logfile generated as:

./log/SCRIPT_LOG_20051220_142937/SCRIPT_LOG

The following table lists the processes that are started at installation:

Process	Log File
EMS Server	.server.log
Script Server	.scriptserver.log
BulkStat Server	.bulkstatserver.log
BulkStat Parser Server	.bulkstatparser.log
Monitor Server (if enabled)	.watchdog.log
NorthBound Server	.northboundserver.log
Notification Service	.notifyservicescript.log

‌

All log files are stored in the /<ems_dir>/server/log directory by default. Refer to log files for additional information in the event that one or more of the processes did not start properly.

Step 7

Copy the un-installation script to the _uninst directory created during the installation process (/<ems_dir>/_uninst by default) by entering the following command:

cp uninst /<ems_dir>/_uninst/

Step 8

Copy the files related to the WEM migrate script to the scripts directory (/<ems_dir>/server/scripts by default) created during the installation process by entering the following command:

cp ems_migrate /<ems_dir>/server/scripts

cp README.ems_migrate /<ems_dir>/server/scripts

Step 9

Refer to the WEM Server Files and Operation chapter of this guide for additional information on WEM Server files and functionality.

Important: Please contact Cisco support for default Username and Password.

Configuring IPMP on WEM Server

With IPMP, two or more network interface cards (bge0, bge1 etc.) are dedicated for each network to which the host connects. Each interface is assigned a static “test” IP address, which is used to access the operational state of the interface. Each virtual IP address is assigned to an interface, though there may be more interfaces than virtual IP addresses, some of the interfaces being purely for standby purposes. When the failure of an interface is detected its virtual IP addresses are swapped to an operational interface in the group.

The IPMP load spreading feature increases the machine's bandwidth by spreading the outbound load between all the cards in the same IPMP group.

Important: IPMP is a feature supported on Sun® Solaris® provided by Sun Microsystems. The configuration is included in Section VI of the System Administration Guide: IP Services from Sun Microsystems. For more information, refer to the Sun documentation

This section describes following procedures to configured IP Multipathing on WEM server:

•	Configuring Probe-based IP Multipathing

•	Configuring Link-based IP Multipathing

Before proceeding for IPMP configuration here are some terms related to IPMP configuration:

•	Multipath Interface Group: This the name given to the group of network devices in a multipath configuration.

•	Test Addresses: These are IP addresses assigned to each board/interface of the multipath group, they do not move but should not be used for connections in or out of the host.

•	Multipath/float Address - This is the IP address allocated to a Multipath Interface Group that is shared between all devices in the group (either by load sharing or active standby).

Configuring Probe-based IP Multipathing

Configuration procedure given here assumes that:

•	WEM Server Host name is hostname

•	NIC_1 and NIC_2 are the network interface devices; i.e. bge0, bge1 etc.

•	Using network device NIC_2 as active and NIC_1 as the Standby

•	Multipath Interface Group name is multipath_grp

•	Multipath IP address is <multipath_IP_address>

•	Test IP address for <NIC_1> interface in <test_IP_address_NIC_1>

•	Test IP address for <NIC_2> interface in <test_IP_address_NIC_2>

Step 1

Ensure that the MAC addresses on the host are unique by setting the local-mac-address parameter to true by running following command as root user:

eeprom local-mac-address?=true

Step 2

Create an NIC_1 for the Standby network device with the following entry:

<hostname>-<NIC_1> netmask <netmask> broadcast+group <multipath_grp> deprecated -failover standby up

<hostname> is name of the Host and <NIC_1> is the network device to be set as Standby.

<multipath_grp> is Multipath Interface Group name given to the group of network devices in a multipath configuration.

<netmask> is the sub-netmask used by network.

Step 3

Create an NIC_2 for the active network device with the following entry:

<hostname>-<NIC_2> netmask 255.255.255.0 broadcast+group <multipath_grp> deprecated -failover up addif <hostname>-active netmask 255.255.255.0 broadcast+failover up

<hostname> is name of the Host and <NIC_2> is the network device to be set as Active.

<multipath_grp> is Multipath Interface Group name given to the group of network devices in a multipath configuration.

Step 4

Edit the /etc/hosts file using “vi editor” and add the following three entries:

<multipath_IP_address> <hostname>-active

<test_IP_address_NIC_1> <hostname>-NIC_1

<test_IP_address_NIC_2> <hostname>-NIC_2

multipath_IP_address is the IP address allocated to a Multipath Interface Group that is shared between all devices in the group (either by load sharing or Active-Standby).

test_IP_address_NIC_1 is the IP addresses assigned to <NIC_1> interface of the multipath group, they do not move but should not be used for connections in or out of the host.

test_IP_address_NIC_2 is the IP addresses assigned to <NIC_2> interface of the multipath group, they do not move but should not be used for connections in or out of the host.

Step 5

Restart the host by supplying following command:

shutdown -i 6 -g 0 -y

Configuring Link-based IP Multipathing

Configuration procedure provided here assumes that:

•	WEM Server Host name is <hostname>

•	<NIC_1> and <NIC_2> are the network interface devices; i.e. bge0, bge1 etc.

•	Using network device <NIC_1> as active and <NIC_2> as the standby

•	Multipath Interface Group name is <multipath_grp>

•	Multipath IP address is <multipath_IP_address>

•	Test IP address for <NIC_1> interface in <test_IP_address_NIC_1>

•	Test IP address for <NIC_2> interface in <test_IP_address_NIC_2>

•	<my_address> is associated with Multipath IP address <multipath_IP_address> in the /etc/hosts file

Step 1

Ensure that the MAC addresses on the host are unique by setting the local-mac-address parameter to true by running following command as root user:

eeprom local-mac-address?=true

Step 2

Create an NIC_1 for the Active network device with the following entry:

<my_address> netmask + broadcast + group <multipath_grp> up

<my_address> is associated with Multipath IP address <multipath_IP_address> in the /etc/host file.

<multipath_grp> is Multipath Interface Group name given to the group of network devices in a multipath configuration.

Step 3

Create an NIC_2 for the Standby network device with the following entry:

group <multipath_grp> up

Step 4

Restart the host by supplying following command:

shutdown -i 6 -g 0 -y

 

 

Cisco Systems Inc.

Tel: 408-526-4000

Fax: 408-527-0883